qiqi.format

方法

方法	描述
formatNumber(value: number, format: string): string	格式化一个数值。
formatDate(value: Date, format: string): string	格式化一个日期。

数值格式化类型

支持的数字格式有：

• 标准
• 自定义

标准

可以通过传递标准字符串格式来格式化数字。

• “n”说明符 - 将数字格式化为十进制数。要指定精度，请在“n”之后添加一个数字。默认情况下，该数字经过格式化并四舍五入为小数点后两位。

qiqi.format.formatNumber(1234.5678, "n"); // 1,234.57
qiqi.format.formatNumber(1234.5678, "n5"); // 1,234.56780

• “p”说明符 -将数字格式化为百分比。传递的数字乘以 100。要指定精度，请在“p”之后添加一个数字。默认情况下，数字被格式化并四舍五入到小数点后两位。

qiqi.format.formatNumber(0.56786, "p"); // 56.79%
qiqi.format.formatNumber(0.5678, "p5"); // 56.78000%

• “e”说明符 - 以指数表示法格式化数字。

qiqi.format.formatNumber(0.45678, "e0"); // 5e-1

自定义

您可以使用一个或多个自定义数字说明符创建自定义数字格式字符串。自定义数字格式字符串是任何非标准数字格式的字符串。

支持的格式说明符是：

• “0” 说明符 - 零占位符。如果存在一个，它将用相应的数字替换零。否则，结果字符串中将出现零。

qiqi.format.formatNumber(1234.5678, "00000"); // 01235

• “#” 说明符—数字占位符。如果存在，它将用相应的数字替换“#”符号。否则，结果字符串中不会出现数字。

qiqi.format.formatNumber(1234.5678, "#####"): // 1235

• "." 说明符 - 小数占位符。它确定结果字符串中小数点分隔符的位置。

qiqi.format.formatNumber(0.45678, "0.00"); // 0.46

• "," 说明符 - 组分隔符占位符。它在每个组之间插入一个本地化的组分隔符。

qiqi.format.formatNumber(12345678, "##,#"); // 12,345,678

• "%" 说明符 - 百分比占位符。它将一个数字乘以 100 并在结果字符串中插入一个本地化的百分比符号。

% 符号会被解释为格式字符串中的格式说明符。为防止这种情况，可以在 % 符号前加上一个双反斜杠 — formatNumber(12, "# \\%") 得到 12 %。

qiqi.format.formatNumber(1.1, "#.0 %"); // 110.0 %

• ”;”说明符 - 节分隔符。它为正数、负数和零数定义了具有单独格式字符串的部分。

qiqi.format.formatNumber(-123, "##,#;(##,#)"); // (123)

日期格式化类型

支持的日期格式有：

• 标准
• 自定义

标准

• "d" 说明符—呈现短日期模式：“yyyy/MM/d”。

qiqi.format.formatDate(new Date(2000, 10, 6), "d"); // 2000/11/6

• "D" 说明符 - 呈现长日期模式：“yyyy年M月d日”。

qiqi.format.formatDate(new Date(2000, 10, 6), "D"); // 2000年11月6日

• "F" 说明符 - 呈现完整的日期和时间模式："yyyy年M月d日 hh:mm:ss"

qiqi.format.formatDate(new Date(2000, 7, 6, 20, 22, 12), "F"); // 2000年8月6日 20:22:12

• "g" 说明符 - 呈现短日期和时间模式："yyyy/M/d hh:mm"

qiqi.format.formatDate(new Date(2000, 7, 6, 20, 22, 12), "F"); // 2000/8/6 20:22

• "G" 说明符 - 呈现短日期和时间模式："yyyy/M/d hh:mm:ss"

qiqi.format.formatDate(new Date(2000, 7, 6, 20, 22, 12), "F"); // 2000/8/6 20:22:12

• "M" 说明符 - 呈现月和日模式：“M月d日”

qiqi.format.formatDate(new Date(2000, 7, 6), "M"); // 8月6日

• "m" 说明符 - 呈现月和日模式：“M月d日”

qiqi.format.formatDate(new Date(2000, 7, 6), "m"); // 8月6日

• "Y" 说明符 - 呈现缩写的模式："yyyy年M月"

qiqi.format.formatDate(new Date(2000, 10, 6), "Y"); // 2000年11月

• "y" 说明符 - 呈现缩写的模式："yyyy年M月"

qiqi.format.formatDate(new Date(2000, 10, 6), "y"); // 2000年11月

自定义

以下说明符可用于自定义格式。

• “y”说明符—呈现年份。 要呈现全年，请使用一个字母。要呈现两位数的年份，请使用两个字母。

qiqi.format.formatDate(new Date(2011, 0, 1), "yy"); // 11
qiqi.format.formatDate(new Date(2011, 0, 1), "yyyy"); // 2011

• “M”说明符—呈现月份。

qiqi.format.formatDate(new Date(2011, 10, 6), "MM"); // 11
qiqi.format.formatDate(new Date(2011, 10, 6), "MMM"); // 11月
qiqi.format.formatDate(new Date(2011, 10, 6), "MMMM"); // 十一月

• “d”说明符—呈现月份中的某一天。 要显示最小位数，请使用“d”。要始终显示两位数，请使用“dd”（必要时补零，例如“08”）。

qiqi.format.formatDate(new Date(2021, 10, 6), "yy d"); // 21 6
qiqi.format.formatDate(new Date(2021, 10, 6), "yy dd"); // 21 06

• “h”说明符 - 使用从 1 到 12 的 12 小时制呈现小时。 要显示最小位数，请使用“h”。要始终显示两位数，请使用“hh”。

qiqi.format.formatDate(new Date(2000, 0, 1, 13), "h"); // 1
qiqi.format.formatDate(new Date(2000, 0, 1, 13), "h"); // 01

• “H”说明符 - 使用从 1 到 23 的 24 小时制呈现小时。 要显示最小位数，请使用“H”。要始终显示两位数，请使用“HH”。

qiqi.format.formatDate(new Date(2000, 0, 1, 13), "H"); // 13
qiqi.format.formatDate(new Date(2000, 0, 1, 9), "HH"); // 09

• “m”说明符 - 呈现从 0 到 59 的分钟。 要显示最小位数，请使用“m”。要始终显示两位数，请使用“mm”。

qiqi.format.formatDate(new Date(2000, 0, 1, 1, 1), "H:m"); // 1:1
qiqi.format.formatDate(new Date(2000, 0, 1, 1, 1), "H:mm"); // 1:01

• “s”说明符—呈现从 0 到 59 的秒数。 要显示最小位数，请使用“s”。要始终显示两位数，请使用“ss”。

qiqi.format.formatDate(new Date(2000, 0, 1, 1, 1, 1), "HH:mm:s"); // 01:01:1
qiqi.format.formatDate(new Date(2000, 0, 1, 1, 1, 1), "HH:mm:ss"); // 01:01:01